Required

• git

• github account

• RStudio or text editor

Version control

Version control

• large space requirements
• difficult to collaborate

Git

Git - overview

• Git - is a distributed version control system

• Git - stores snapshots of the filesystem
• commits

Git - overview

Files can be in one of four states:

• untracked

Git - overview

Files can be in one of four states:

• untracked
• staged

Git - overview

Files can be in one of four states:

• untracked
• staged
• committed

Git - overview

Files can be in one of four states:

• untracked
• staged
• committed
• modified

Git - overview

Git - overview

Git - configuration

This is a once off action (per machine)

• define who you are

git config --global user.name "Your name"
git config --global user.email "your_email@whatever.com"

git config --global init.defaultBranch main

git config --global --list

user.name=pcinereus
user.email=i.obesulus@gmail.com
init.defaultbranch=main

Git - configuration

Or within R (via the usethis package)

usethis::use_git_config(user.name='Your name',
               user.email='your_email@whatever.com',
               scope='user')
usethis::git_sitrep()

OR via the gert package

gert::git_config_global()

Git - new repository

mkdir ~/tmp/Test_repo
cd ~/tmp/Test_repo

git init

RStudio

R

library(usethis)
create_project(path='~/path/project_name', rstudio=TRUE)
use_git()

Git - adding content

Create a file (text, code etc)

• those using R, call it analysis.R

x=seq(1, 10, len = 1)
y=40 * 2 + rnorm(10, 0, 5)
plot(x, y)

Otherwise, create any kind of file (in the folder we just created)

Git - adding content

Stage the changes (add)

git add <file(s)>

For example:

git add analysis.R

RStudio

gert::git_add('analysis.R')

Git - adding content

Git - .gitignore

RStudio

Examples

• .RData all files ending in .RData
• .pdf all files ending in .pdf
• data/ the entire folder called data

Git - committing

git commit -m 'Initial commit'

[main (root-commit) 1b2c303] Initial commit
 1 file changed, 3 insertions(+)
 create mode 100644 analysis.R

cd ~/tmp/Test_repo
git status

On branch main
nothing to commit, working tree clean

RStudio

gert::git_commit('Initial commit')

Git - committing

Git - additional edits

• Make some changes to the file, stage (add) and commit

x=seq(1, 10, len=1)
y=40*2 + rnorm(10,0,5)
plot(x,y)
summary(x)

[main ee747c8] Added summary for x
 1 file changed, 1 insertion(+)

Git - additional edits

• Lets remove the summary(x) and add it to another file, stage (add) and commit

analysis.R

x=seq(1, 10, len=1)
y=40*2 + rnorm(10,0,5)
plot(x,y)

summary.R

summary(x)
summary(y)

[main 29d3ff4] Added summaries for x and y
 2 files changed, 5 insertions(+), 4 deletions(-)
 create mode 100644 summary.R

Git - additional edits

Git - history (logs)

git log --oneline --graph --decorate

* 29d3ff4 (HEAD -> main) Added summaries for x and y
* ee747c8 Added summary for x
* 1b2c303 Initial commit

RStudio

Git - history (logs)

gert::git_log(max=10)

                                    commit                           author
1 29d3ff45df1b642c22c42996c9a6e522b7a78e42 pcinereus <i.obesulus@gmail.com>
2 ee747c8b73c9fd609b36a8ea07943270798cd733 pcinereus <i.obesulus@gmail.com>
3 1b2c30363df9df9d9f02a9b202dcb06a867f5cbc pcinereus <i.obesulus@gmail.com>
                 time files merge                       message
1 2024-07-28 10:51:43     2 FALSE Added summaries for x and y\n
2 2024-07-28 10:51:43     1 FALSE         Added summary for x\n
3 2024-07-28 10:51:42     1 FALSE              Initial commit\n

A listing (data.frame) of tracked files

gert::git_ls()

        path filesize            modified             created
1 analysis.R       53 2024-07-28 10:51:43 2024-07-28 10:51:43
2  summary.R       22 2024-07-28 10:51:43 2024-07-28 10:51:43

Git - tags

git tag -a <tag> -m <message>

For example:

git tag -a 'V.1' -m 'Version 1'

R/RStudio

gert::git_tag_create(name='V1', message='Version 1')

Git - tags

Git - rolling back

1. checkout

2. reset

3. revert

Git - checkout

git checkout #

# is a commit or tag name

git checkout  ee74

R/RStudio

gert::git_branch_create(branch = 'temp', ref = 'ee74', checkout = TRUE)

Git - checkout

Git - checkout

Restore the HEAD to the tip of main

git checkout main

Previous HEAD position was ee747c8 Added summary for x
Switched to branch 'main'

R/Rstudio

gert::git_branch_checkout(branch = 'main')

Git - checkout

Git - reset

git reset --hard #

# is a commit or tag name

cd ~/tmp/Test_repo
git reset --hard ee74

R/RStudio

gert::git_reset_hard(ref='ee74')

Git - reset

Git - reset

Restore HEAD to the tag V.1

git reset --hard V.1

HEAD is now at 29d3ff4 Added summaries for x and y

R

gert::git_reset_hard(ref='V.1')

Git - reset

Git - revert

git revert HEAD --no-edit

[main 9e2d591] Revert "Added summaries for x and y"
 Date: Sun Jul 28 10:51:50 2024 +0000
 2 files changed, 4 insertions(+), 5 deletions(-)
 delete mode 100644 summary.R

RStudio

Git - revert

Git - revert multiples

command line

git revert --no-commit HEAD
git revert --no-commit HEAD~1
git commit -m 'Rolled back'

RStudio

Git - new branch

git checkout -b <Name>

For example

git checkout -b Experimental

RStudio

Git - new branch

Git - branch

We are on the new branch

• add or edit some content
  • stage and commit

x=seq(1, 10, len=1)
y=40*2 + rnorm(10,0,5)
plot(x,y)
summary(x)
mean(x)

Otherwise, create any kind of file (in the folder we just created)

Git - branch

Git - switch branch

git checkout <Name>

For example:

git checkout main

RStudio

Git - switch branch

Git - branch

We are on the main branch

• add another file (test.R)
  • stage and commit

mean(c(1,2,3))

Otherwise, create any kind of file

Git - branch

Git - branch log

git log --online --graph --decorate --all

RStudio

Git - diff

git diff main <branch>

For example:

git diff main Experimental

diff --git a/analysis.R b/analysis.R
index 2318425..668a9b6 100644
--- a/analysis.R
+++ b/analysis.R
@@ -2,3 +2,4 @@ x=seq(1, 10, len = 1)
 y=40 * 2 + rnorm(10, 0, 5)
 plot(x, y)
 summary(x)
+mean(x)
diff --git a/test.R b/test.R
deleted file mode 100644
index 0242716..0000000
--- a/test.R
+++ /dev/null
@@ -1 +0,0 @@
-mean(c(1,2,3))

Git - merge branches

git merge <Name>

For example:

cd ~/tmp/Test_repo
git merge Experimental -m 'Merge main and Experimental'

Merge made by the 'ort' strategy.
 analysis.R | 1 +
 1 file changed, 1 insertion(+)

RStudio

gert::git_branch_checkout('main') # ensure on main branch
gert::git_merge(ref='Experimental')

Git - merge branches